home *** CD-ROM | disk | FTP | other *** search
/ Freelog Special Edition 13 / FreelogHS13.iso / P To P / eMulePlus-0.24b-4-Mav / readme.txt < prev    next >
Text File  |  2002-12-24  |  11KB  |  321 lines
  1. eMule Copyright (C)2002 Merkur (merkur-@users.sourceforge.net)
  2.  
  3.  
  4. This program is free software; you can redistribute it and/or
  5. modify it under the terms of the GNU General Public License
  6. as published by the Free Software Foundation; either
  7. version 2 of the License, or (at your option) any later version.
  8.  
  9. This program is distributed in the hope that it will be useful,
  10. but WITHOUT ANY WARRANTY; without even the implied warranty of
  11. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12. GNU General Public License for more details.
  13.  
  14. You should have received a copy of the GNU General Public License
  15. along with this program; if not, write to the Free Software
  16. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  17.  
  18.  
  19. -----------------------------------------------------------------------------------
  20.  
  21.  
  22. Welcome to eMule, a filesharing client based on the eDonkey2000(C) network.
  23.  
  24.  
  25. Visit us at
  26.  http://www.emule-project.net
  27. and
  28.  http://sourceforge.net/projects/emule
  29. or
  30.  the IRC chatroom, #emule on irc.emule-project.net
  31.  
  32.  
  33.  
  34. Please remember that this is an early version, not all features are implemented yet,
  35. and not everything might work as intended.
  36.  
  37. Visit our forum for bugreports, feature requests, development or general dicussion.
  38.  
  39.  
  40. If you have questions or serious problems, please read the FAQ first :)
  41.  
  42. The English FAQ can be found at: http://www.emule-project.net/en/viewforum.php?f=8
  43. The German FAQ is here: http://www.emule-project.net/en/viewforum.php?f=21
  44. A small collection of questions is also discussed later in this document.
  45.  
  46.  
  47. If you didn't find an answer, SEARCH the forum for a topic related to your problem,
  48. DO NOT open a new topic at once, most likely someone else had the same problem before.
  49.  
  50. The official Forum is here: http://www.emule-project.net/en/index.php
  51. Please use only English there, except for the language-specific sections.
  52. (PLEASE do not report bugs that are already posted by someone else, and keep the
  53. "Bug Reports", "Feature Requests" and "Development" sections clean and shiny)
  54.  
  55.  
  56.  
  57. Would you like to donate to the eMule project?
  58. A PayPal link can be found on the portal page (www.emule-project.net)
  59. Thanks ;)
  60.  
  61.  
  62.  
  63.  
  64. INSTALLATION:
  65. -------------
  66.  
  67. -Unzip eMule to a directory of your choice, or start the installer if you downloaded
  68.  the .exe installer version.
  69.  
  70.  
  71. -You can move your "Temp" and "Incoming" folders from eDonkey (or a previous version
  72.  of eMule) to the new directory now, in order to continue your partial downloads.
  73.  If you don't want to move your folders, you can set the "temp" and "incoming" path
  74.  in the eMule preferences and restart it to get the same result.
  75.  
  76.  
  77.  
  78. START:
  79. ------
  80.  
  81. -Start emule.exe :)
  82.  
  83. -You can fetch a serverlist now to get started. Just go the "Servers" tab, enter
  84.  the URL and press "Update". The working serverlist URLs change rapidly,
  85.  so please look for one on the community pages mentionened below.
  86.  A collection of URLs can be found here: http://www.emule-project.net/en/viewtopic.php?t=1221
  87.  
  88. -Don't forget to connect to a server. You can also activate the "autoconnect on startup"
  89.  option to do it automatically after start.
  90.  
  91.  
  92.  
  93. CONFIGURATION:
  94. --------------
  95.  
  96. -Go to the "Preferences" tab
  97.  
  98. -Enter a nice nickname ;)
  99.  
  100. -Enter the "Download Capacity" and "Upload Capacity" according to your internet connection.
  101.   All values in eMule are kiloBytes (KB), your Internet Service Provider's (ISP) numbers
  102.   are most likely kiloBits (kB). 8 Bits make up 1 Byte, so when your Internet Connection
  103.   is 768kB Downstrean and 128kB Upstrean (like German Telekom DSL), your correct values are:
  104.  
  105.  Downstrean: 768kB / 8 = 96KB, you enter 96 as "Download Capacity"
  106.  Upstream: 128kB / 8 = 16 KB, you enter 16 as "Upload Capacity"
  107.  
  108.  The "capacity" values are used for the statistics display only!
  109.  Nevertheless, you need to know them to determine the following down/upload limits:
  110.  
  111.  
  112. -Enter "Download Limit" and "Upload Limit"  (IMPORTANT!)
  113.  
  114.  Download Limit: leave this at 0 (should eMule become too fast and you are unable to surf
  115.    the Internet or whatever, reduce it to 80-90% of "Download Capacity")
  116.  
  117.  Upload Limit: set this to ~80% of your "Upload Capacity" (so when your Upload Capacity is 16,
  118.    set Upload Limit to 13)
  119.  
  120.    Setting Upload Limit to a value < 10 will automatically reduce your Download Limit, so
  121.    upload as fast as you can.
  122.  
  123.  
  124. NOTE: 56k Modem users: eMule only accepts integral values for these settings at the moment, you
  125.       can't enter 2.6 or whatever your sweet-spot setting is, yet. Sorry :) Maybe later..
  126.  
  127.  
  128.  
  129. -"Maximum Connections": depends on your operating system. As a general rule...
  130.  
  131.   -Windows 95/98/ME ME (and 56k Modem/ISDN) users enter 50 here
  132.   -Windows NT / 2000 / XP users leave this at 500
  133.  
  134. -"Maximum Sources per File": decide for yourself how many you want :)
  135.   when you set this too high, your computer might slow down drastically or even crash
  136.  
  137. -Choose the directories you want to share with other users.
  138.   DO NOT SHARE YOUR COMPLETE HARDDISK!
  139.   Put the stuff you want to share in a seperate Folder.
  140.   If you share more than ~200 files, you should reconsider that...
  141.  
  142. -The other options are pretty self-explaining. If you dunno what it does, don't touch it.
  143.  
  144.  
  145.  
  146.  
  147. FAQ:
  148. ----
  149.  
  150. --"Will I lose my credits when switching to a new version of eMule?"
  151.  
  152.  Not when move your old preferences.dat (your user ID) and clients.met (other people's credits)
  153.  files to the directory you installed the new version in.
  154.  The best way to update is just to replace your old emule.exe with the new one from the .zip download.
  155.  
  156.  
  157.  
  158. --"Why is eMule so slow? My brother/friend/whatever is downloading at 90K constantly"
  159.  
  160.  When you did setup eMule properly, it's all about the availibility of the files you are
  161.  downloading, a bit of luck and a lot of patience ;)
  162.  
  163.  
  164.  
  165. --"Where can I get a new serverlist?"
  166.  
  167.  There are several lists availible. Some that I know of are:
  168.  -http://www.thedonkeynetwork.com
  169.  -http://ed2k.has.it
  170.  And take a look here: http://www.emule-project.net/en/viewtopic.php?t=10361
  171.  
  172.  
  173.  
  174. --"What is the adresses.dat file for?"
  175.  
  176.  You can enter a serverlist URL in that file. eMule will then get the serverlist from that
  177.  URL at startup (when the option "Auto-update serverlist at startup" is activated)
  178.  
  179.  
  180.  
  181. --"What is the staticservers.dat file good for?"
  182.  
  183.  You can enter your favorite servers here to have them permanently in your serverlist
  184.  with high priority. You can enter the static IP of the server, or an adress like
  185.  goodserver.dyndns.net. You can also add static servers to this file via the server tab
  186.  in eMule (right-click -> add to static serverlist)
  187.  
  188.  
  189.  
  190. --"How do I know whether my ID is high or low?"
  191.  
  192.  Look at the arrow in the bottom right corner, next to the server name you are connected to.
  193.  When it's green, your ID is high. When it's orange, your ID is low.
  194.  
  195.  
  196.  
  197. --"What does high and low ID mean anyway?"
  198.  
  199.  When your ID is high (green arrow), everything is fine :)
  200.  When it's low (orange arrow), you are behind a firewall or router, and other clients can't
  201.  connect to you directly (which is a bad thing). Plz read the FAQ or search the forums on 
  202.  how to configure your firewall/router for eMule.
  203.  
  204. NOTE: you can also get a low ID when the server you connected to is too busy to answer
  205.  properly, or simply badly configured. When you are sure your settings are ok and you SHOULD
  206.  have a high ID, connect to antoher server.
  207.  
  208.  
  209.  
  210. --"What is the difference between up/down CAPACITY and LIMIT?"
  211.  
  212.  The CAPACITY is used only by the statistcs tab to determine the vertical limits of the diagram.
  213.  The LIMITS set the actual network traffic limits (see configuration notes).
  214.  
  215.  
  216.  
  217. --"I'd like to search for specific file types, what filter stands for which files?"
  218.  
  219.  File Type    Extensions found
  220.  --------------------------------------------------------------------
  221.  Audio        .mp3 .mp2 .mpc .wav .ogg .aac .mp4 .ape .au .wma
  222.  Video        .avi .mpg .mpeg .ram .rm .vob .divx .mov .ogm .vivo
  223.  Program    .exe .com
  224.  Archive    .zip .rar .ace
  225.  CDImage    .bin .cue .iso .nrg .ccd .sub .img
  226.  Picture    .jpg .jpeg .bmp .gif .tif .png
  227.  
  228.  
  229.  
  230.  
  231. COMPILING THE SOURCECODE:
  232. -------------------------
  233.  
  234. The sourcecode of eMule is availible as seperate download at:
  235.  http://sourceforge.net/projects/emule
  236. You need Microsoft(C) Visual C++ .NET (7.0) to compile eMule.
  237.  
  238. -Unzip the sources (with subdirs) into a new folder
  239. -Open the emule.sln Visual Studio Solution
  240. -Select "release" or "debug" build in the solution configuration manager
  241. -Build the solution. That's it :)
  242. -If the compile was successful, the emule.exe is either in the
  243.  \Debug or \Release directory
  244. -When you build a debug dump version, you need the latest dbghelp.dll from
  245.  Microsoft to run the app
  246.  
  247. -IMPORTANT:
  248.  If you make modifications to eMule and you distribute the compiled version of your
  249.  build, be sure to obey the GPL license. You have to include the sourcecode, or make
  250.  it availible for download together with the binary version.
  251.  
  252.  
  253.  
  254.  
  255. WWW LINKS:
  256. ----------
  257.  
  258. Official
  259. http://sourceforge.net/projects/emule  (download your latest version of eMule here)
  260. http://www.emule-project.net  (FAQ, forum, news and more)
  261.  
  262. Related (we are not responsible for their contents)
  263. http://www.esel-community.de  (German eMule forum and news)
  264. http://edonkey.bei.t-online.de  (German forum, great hints and FAQ section)
  265. http://www.thedonkeynetwork.com  (news, statistics, serverlists and more)
  266.  
  267.  
  268.  
  269.  
  270. MISC. STUFF:
  271. ------------
  272.  
  273. The eMule staff would like to thank the following (no particular order)
  274.  
  275. -Jed "swamp" McCaleb and MetaMachine for bringing the eDonkey network to life
  276. -DrSiRiUs for the awesome artwork (splashscreen and icons)
  277. -OCBmaurice & Stillman for the serverlists and more (www.thedonkeynetwork.com)
  278.  
  279. -many people who sent us code parts, useful bug reports and useful suggestions :)
  280.  
  281.  
  282.  
  283.  
  284. STAFF:
  285. ------
  286.  
  287. Who are the guys that sacrifice so much time to bring you this wonderful program?
  288.  
  289. -John aka. Unknown1 - Developer
  290. -Ornis (ornis@web.de) - Developer
  291. -Dirus - Developer
  292. -Monk, Mr_Ozon and Sony666 - Testers
  293.  
  294. -Merkur (merkur-@users.sourceforge.net) - Master of the Mule
  295. -Tecxx - Developer (retired)
  296. -Pach2 - Developer (retired)
  297. -Juanjo - Developer (retired)
  298.  
  299.  
  300.  
  301. LEGAL:
  302. ------
  303.  
  304. eMule Copyright (C)2002 Merkur (merkur-@users.sourceforge.net)
  305.  
  306. eDonkey2000 (C)Jed McCaleb, MetaMachine (www.eDonkey2000.com)
  307.  
  308. Windows(TM), Windows 95(TM), Windows 98(TM), Windows ME(TM),
  309. Windows NT(TM), Windows 2000(TM) and Windows XP(TM)
  310. are Copyright (C)Microsoft Corporation. All rights reserved.
  311.  
  312.  
  313.  
  314.  
  315. Goodbye and happy sharing ;)
  316.  
  317.  
  318. ...oops, anything not ok with this file?
  319. write me (sony666@users.sourceforge.net) about it
  320.  
  321. \EOF